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Description 

WIRE PROTOCOL FOR A MEDIA SERVER SYSTEM 

5 Technical Field 

The present invention relates generally to computer systems and more 
particularly to a wire protocol for communications between a media server system and a 
client. 

10 Background of the Invention 

The use of computer networks has been gaining popularity. Local area 
networks have become commonplace in business environments, and residential users 
have begun to connect to computer networks, such as the Internet. Multimedia 
applications that generate multiple media output, such as audio output and video output, 

15 have also been gaining popularity. As such, it is not surprising that there has been an 
increase in the number of multimedia applications available on computer networks. In 
general, multimedia data has been transported across computer networks using transport 
protocols such as TCP/IP, but there has been no protocol present on top of such 
. transport protocols for facilitating efficient and useful communications between clients 

20 and multimedia servers. 

Summary of the Invention 

The present invention overcomes the limitations of the prior art by 
adding an additional layer on top of a transfer protocol layer to facilitate 

25 communications between a client on a first computer and a media server on a second 
computer. In accordance with a first aspect of the present invention, a method is 
practiced in a computer network that has a media server for storing data and a client. 
Per this method, a wire protocol is provided that facilitates creation of connections 
between the media server and the client The wire protocol is utilized to create a control 

30 connection between the media server and the client to facilitate exchange of control 
information. The wire protocol is also used to create a data connection between the 
media server and the client that facilitates the exchange of data between the media 
server and the client at a rate substantially equal to a rate at which the data is consumed 
by the client 

35 In accordance with another aspect of the present invention, a control 

connection is created to enable control information to pass between a media server and 
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a client computer in a distributed system that are on separate computers. A data funnel 
connection is created to enable data to be transferred between the media server and the 
client at a rate substantially equal to the rate at which the client consumes data. 

In accordance with an additional aspect of the present invention, a first 
5 request for service is sent from a client to a media server. The first request includes a 
first identifier that uniquely identifies the first request. A second request for service is 
also sent from the client to the media server. The second request includes a second 
identifier that uniquely identifies the second request and that differs from the first 
identifier. The media server asynchronously services the first request and returns an 
10 acknowledgment to the client. The acknowledgment includes the first identifier. The 
media server asynchronously services the second request and returns an 
acknowledgment that includes the second identifier. 

In accordance with a further aspect of the present invention, a method of 
decreasing network traffic is practiced in a computer network that has a media server 
15 connected to a client via a network connection. Multiple messages are batched into a 
single message at the client. A single message is then sent from the client to the media 
server. The media server unbatches the multiple messages and processes each of the 
multiple messages. 

In accordance with another aspect of the present invention, a method is 
20 practiced in a distributed system that has a media server for storing files holding data of 
multiple media, and a client for requesting service from the media server. A control 
connection connects the media server and the client to pass control information, and a 
data connection connects the media server and the client to pass data. Per the method of 
this aspect of the present invention, a read request message is sent from the client to the 
25 media server over the control connection. The read request message requests that data 
in a file of multiple media data stored at the media server be read and output to the 
client. A read request acknowledgment message is sent from the media server to the 
client over the control connection to acknowledge the read request message. The 
requested data is then forwarded from the media server to the client over the data 
30 connection. 

In accordance with yet another aspect of the present invention, a write 
request message is sent from a client to a media server over a control connection. The 
write request message requests that data from the client be written into a file at the 
media server. A write request acknowledgment message is sent from the media server 
35 to the client over the control connection to acknowledge the write request message. The 
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data to be written is forwarded from the client to the media server over the data 
connection, and the forwarded data is written into a file at the media server. 

In accordance with a further aspect of the present invention, a computer 
system is part of a distributed system that has a media server for storing files that hold 
5 data of multiple media. The computer system includes a control connection generator 
for generating a bidirectional control connection between the media server and the 
computer system. The control connection enables control information to be passed 
between the media server and the computer system. The computer system also includes 
a data connection generator for creating a bidirectional data connection between the 
10 media server and the computer system. The data connection enables data to be passed 
between the media server and the computer system. 

Brief Description of the Drawings 

The present invention will be described in more detail below relative to 
15 the following figures. 

Figure 1 is a block diagram of a distributed environment that is suitable 
for practicing the preferred embodiment of the present invention. 

Figure 2 is a flowchart illustrating the steps that are performed to send 
batched messages in accordance with the preferred embodiment of the present 
20 invention. 

Figure 3" is a flowchart that illustrates the steps that are-gerformed to 
establish a control link between a client and a controller. 

Figure 4 is a flowchart that illustrates the steps that are performed to 
establish a data funnel connection between a client and data servers in a media storage. 
25 Figure 5 is a flowchart illustrating the steps that are performed for a 

. client to read a file of data stored on a media server system in the preferred embodiment 
of the present invention. 

Figure 6 is a flowchart illustrating the steps that are performed for a 
client to write data into a file that is stored on the media storage system in the preferred 
30 embodiment of the present invention. 

Figure 7 is a flowchart illustrating the steps that are performed to obtain 
requested information for a client in accordance with the preferred embodiment of the 
present invention. 

Figure 8 is a flowchart illustrating the step that is performed for a client 
35 to unilaterally initiate an action via the wire protocol in accordance with the preferred 
embodiment of the present invention. 
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Detailed Description of the Invention 

The preferred embodiment of the present invention provides a wire 
protocol on top of a transport layer to facilitate communications between a media server 
system and a client The wire protocol of the preferred embodiment provides a number 
of messages that simplify communication between the client and the server and provide 
functionality that is well-suited for interaction with the media server system. For 
example, the wire protocol enables multiple network connections to be established 
between a client and the media server system. In particular, a control link connection 
may be established to facilitate the communication of control information between the 
media server system and the client, and a data link connection may be established to 
facilitate the transfer of data between the client and the server. The wire protocol 
facilitates multiple requests for service from the server to be concurrently outstanding. 
These requests are handled in an asynchronous fashion. A unique identification, 
denoted as an "incarnation," is included with each request and response to disambiguate 
responses to requests. In other words, the incarnation enables a response to be matched 
with a request. The wire protocol also enables multiple messages to be batched together 
in a single message that may be transmitted over the network in a single packet rather 
than in separate packets, thus reducing network traffic. The preferred embodiment is 
well adapted for use with data files that contain data of different media. Nevertheless, 
_the present invention may also be usedwith single medium data files. — _ 

Figure 1 is a block diagram depicting a networked environment 10 that is 
suitable for practicing the preferred embodiment of the present invention. The 
networked environment 10 includes a computer system 12 that is connected to a 
controller 14 for a media server system. The computer 14 may be one of numerous 
controllers in the system that are provided to enhance fault tolerance and to help in load 
balancing. The controller 14 controls access to media storage 16 which stores files 
holding data of multiple media. The computer system 12 is connected to the controller 
14 via control link 18. The control link 18 is a bidirectional logical connection that 
facilitates messages being passed between the controller 14 and the computer system 
12. The computer system 12 is also connected to the media storage 16 via a data funnel 
20. The data funnel 20 is a bidirectional logical connection that connects the respective 
media storage managers, denoted as cubs, 22A, 22B and 22C, with the computer system 
12. These logical connections are established on top of one or more physical 
connectors, such as an "ETHERNET" wire, a phone line or fiber optic line. The wire 
protocol facilitates the creation of the control link 18 and the data funnel 20, as will be 



( 

5 

described in more detail below. The computer system 12 runs code 26 that constitute a 
viewer 26 for viewing output that is read from media storage 16. The viewer 26 acts as 
a client of the multimedia system formed by the controller 14 and the media storage 16. 
Those skilled in the art will appreciate that the viewer 26 may be part of an application 
5 program, part of an operating system, or, alternatively, part of a dynamic link library 
(DLL) module. The viewer 26 includes support for the wire protocol of the preferred 
embodiment. 

As was mentioned above, the wire protocol of the preferred embodiment 
of the present invention facilitates multiple network connections to be established to 

10 service requests. The first connection is the control link 18, and the second connection 
is the data funnel 20. The control link 18 uses the TCP/IP protocol to send commands 
in the form of messages between the viewer 26 and the controller 14, and the data 
funnel 20 relies upon the UDP protocol to transfer data between the viewer and the 
controller (although the TCP/IP protocol may be used as well). Nevertheless, those 

15 skilled in the art will appreciate that different transport layer protocols may be utilized. 
The controller 14 and viewer 26 use the UDP datagram protocol to package blocks of 
data that are sent over the data funnel 20. Other datagram protocols may also be used 
by the present invention. It should be appreciated that the data funnel 20 is a 
multipoint-to-point connection that connects each of the cubs 22A, 22B and 22C to the 

20 computer system 12. It should be also appreciated that the present invention may 
include multiple clients and multiple media server systems. A-single viewer and a 
single multimedia server system are depicted in Figure 1 for purposes" of clarity and 
simplicity. 

In the preferred embodiment of the present invention, the cubs 22 A, 22B 
25 and 22C hold multimedia data that may be played upon a request by a subscriber who 
uses the computer system 12. A more detailed description of such a multimedia on 
demand system is described in U.S. Patent No. 5,473,362, which is explicitly 
incorporated by reference herein. 

Multiple messages may be batched into a single message structure for 
30 transmission over the control link 18. A batch of messages starts with a header that 
contains the length of the batch of messages. The header is followed by a list of 
messages that are concatenated. Each of the messages begins with a header that 
describes the size of the message and the type of message. Each message that is sent 
over the control link 18 has the following format: 

35 
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struct LinJcMessage { 

int chunkLen; 
int MID; 

} 

5 

The chunkLen field specifies the length of the message in 8-byte units. The MID field 
is a message identifier. A message identifier is a numerical value that specifies a 
message type, where each message type has a unique numerical value associated with it 
Figure 2 is a flowchart illustrated in the steps are performed to batch 

10 messages that are sent to the control link 1 8. First the messages are packed into a single 
message (step 3 1 in Figure 2). The single message is then transmitted over the control 
link 18 (step 33 in Figure 2). The recipient of the message then unpacks the message 
(step 35 in Figure 2). As noted above, the batch of messages starts with a header that 
contains the length of the batch. This header is followed by a concatenated list of 

15 messages, each of which contains its own header. Each message header identifies the 
size of the message, and, thus, these headers may be utilized in conjunction with the 
batch header to unpack the respective messages until no messages remain to be 
unpacked. 

Figure 3 is a flowchart that illustrates the steps that are performed to 
20 realize control link 18 between the viewer 26 and the controller 14 using the wire 
protocol of the preferred embodiment of the present invention. The viewer 26 initiates 
the creation of the control link 18 by requesting a control link connection (step 28 in 
Figure 3). In particular, the viewer 26 sends a message to the controller 14 that has the 
following format, - 

25 

struct LinkViewerToMacConnectMessage 
: public LinJcMessage { 

int MacToViewerProtocolRevision; 
int ViewerToMacProtocolRevision; 
30 int blackHole; 

char s ubsc rib e rName []; //length as required 

}; 



The protocol revision fields of this message specify protocol revision numbers that 
35 identify which version of a protocol is being used. The fields of the message also 
specify the subscriber name. The controller 14 receives the request message from the 
viewer, establishes the control link and returns a response to the viewer to inform the 
viewer of the successful creation of the control link (step 30 in Figure 3). The message 
that is returned to the viewer 26 has the following format 
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struct LinkMacToViewerReportConnectedMessage 
: public LinkMessage { 
int MacToViewerProtocolRevision; 
int ViewerToMacProtocolRevision; 
5 Time biockGroupPlayTime; 

unsigned blockGroupBlocks; 
unsigned nMaxOpenFiles; 
uns igned nBloc JcMaxBytes ; 

unsigned maxBitRate; 

10 }; 



The biockGroupPlayTime field is of the Time data type and specifies the amount of 
time it takes a consumer (e.g., viewer 26) of the block of data to render the block of 
data. It should be noted that the Time data type is a double precision floating point 

15 value. Each file of multiple media data is divisible into fixed size blocks. The 
blockGroupBIocks field specifies the number of blocks in a group. The 
nMaxOpenFiles field specifies the maximum number of files that may be concurrently 
opened by a single client on the multimedia server system formed by the controller 14 
in media storage 16. The nBlockMaxBytes field specifies the maximum block size in 

20 bytes. Lastly, the maxBitRate field specifies the maximum bit rate of transmission of 
the blocks. 

The data funnel 20 is created by passing messages in accordance with the 
wire protocol of the preferred embodiment of the present invention. Figure 4 is a 
flowchart illustrating the steps that are performed to create the funnel connection 20. 
25 Initially, the viewer 26 sends a request message to create a funnel to the controller 14 
(step 32 in Figure 4). The request message has the following format. 

struct LinkViewerToMacConnectFunnelMessage 
; public LinkMessage { 
30 unsigned maxBlockBytes ; 

unsigned maxFunnelBytes; 
uns igned f unne IMode ; 

char f unne IName []; //length as required 

}; 

35' 

The maxBlockBytes field specifies the maximum number of bytes in a block that the 
viewer desires. The maxFunnelBytes field specifies the maximum number of bytes per 
network datagram that is sent across the funnel connection. The fiinnelMode field 
identifies the current mode as "read," "write" or "read/write." Lastly, the funnelName 
40 field holds the characters and the name of the funnel specifies the type of transport 
being used. 

The controller 14 receives the viewer request message and creates the 
appropriate data funnel connection (step 34 in Figure 4). The controller 14 sends a 
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response message back to the viewer 26 to indicate that the funnel has been successfully 
created. The response message has the following format. 

struct LinkMacToViewerReportConnectedFunnelMessage 
5 : public LinkMessage { 

char f unnelName [ ] ; //length as required 

); 

As can be seen, the message specifies the name of the funnel. If for some reason, the 

10 controller 14 is unable to create the data funnel connection 20, the controller sends a 
ReportDisconnectedFunnelMessage (which is described in more detail below). 

The wire protocol also enables the viewer 26 to request the playing of a 
data sequence by the multimedia server system on behalf of the viewer so that the 
multimedia output is delivered from the media storage 16 to the viewer 26, Figure 5 is 

15 a flowchart illustrating the steps that are performed to initiate such playing of a 
multimedia sequence. Initially, the viewer 26 asks for the creadon of a control link with 
the controller 14 by sending the LinkViewerToMacConnectMessage (described above) 
to the controller (step 36 in Figure 5). The controller 14 then establishes the control 
link 18 (step 38 in Figure 5). The controller 14 then sends the 

20 LrnkMacToViewerReportConnectedMessage (described above) to the viewer 26. If 
the control link 18 is already established, these steps are not necessary. The viewer 26 
next asks the controller 14 to establish a data funnel connection 20 by sending the 
LinkViewerToMacConnectFunnelMessage (described above) to the controller 14. The 
data funnel connection is created and the 

25 LinkMacToViewerReportConnectedFunnelMessage (described above) is sent from the 
controller 14 to the viewer 26 (step 40 in Figure 5). These steps need not be repeated if 
a data funnel connection already exists. 

The viewer 26 subsequently selects a file (step 42 in Figure 5). The 
selected file must be opened. In order to open the file, the viewer 26 sends a request to 

30 open the file to the controller 14. The request message has the following format. 

struct LinkVi ewe rToMacOpenFileMes sage 
: public LinkMessage { 

int playlncarnation; 
35 char complete FileName [ ] ; 

>; 

The playlncarnation field specifies the incarnation for this request. As was discussed 
above, multiple requests may be concurrently outstanding and the requests are 
40 asynchronously handled. As a result, there must be a mechanism in place for matching 
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responses with requests. The incarnation serves as a basis for identifying each request 
so that responses may be matched with requests. 

The controller 14 receives the request to open the file, opens the file and 
sends a response message. The response message has the following format 

5 

struct LinkMacToViewerReportOpenFileMessage 
: public LinJcMessage { 
Win32Error dwError; 
ln int playlncarnation; 

IU unsigned openFiield; 

uns igned tigerFileld ; 

unsigned blockODiskld; 
unsigned blocJcOCubld; 
char *name; 
15 MmsFileEntry entry [1]; 

>; 

The dwError field specifies an error code which identifies which error occurred, if any, 
in opening the file. The playlncarnation field holds a play incarnation value. The 

20 openFiield field specifies a handle for the file that has been opened. The tigerFileld 
field specifies an ID associated with the file that has been opened. Different clients may 
receive different openFileld's for a same file but each will receive the same tigerFileld. 
The blockODiskld field identifies the Id of the storage disk that holds the first block of 
the file that has been opened. Similarly, the blockOCubld holds the Id of the cub 22 A, 

25 22B and 22C which holds the first block of the file that has been opened. The name 
field holds the name of the file and the entry field holds a file entry having information 
about the file. 

The viewer 26 must then identify that the file is to serve as the "current 
file." The "current file" is a variable value that is maintained by the controller 14 to 
30 determine to which file subsequent play/stop messages should refer. Thus, as part of 
the selection of a file, the viewer 26 sends a message that sets a value for the current file 
variable to be the file of interest. In particular, the viewer 26 sends a message with the 
following format 

35 struct LinkViewerToMacSetCurrentFileMessage 

: public LinJcMessage { 
unsigned openFiield; 

>; 

40 The openFiield field holds a handle that uniquely identifies the file of interest. 

Once these steps have been completed, the viewer may ask for data from 
the file to be played (step 44 in Figure 5). This viewer 26 sends a message with the 
following format. 
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struct LinkViewerToMacStartPlayingMessage 
: public LinkMessage { 
Time position; 
int frameOffset; 
int playlncarnation; 

}; 



The position field specifies a position in the file where the viewer 26 is to begin 
10 playing. The frameOffset field is reserved and the playlncarnation field identifies the 
incarnation value for the play request. 

The controller 14 returns a message to specify that playing has begun 
(see step 46 in Figure 5). This message takes the following format 

15 struct LinkMacToViewerReportStartedPlayingMessage 

: public LinkMessage { 

Win32Error dwError; 

int playlncarnation; 

unsigned tigerFileld; 
20 uns igned numFileBlocks ; 

unsigned fileBlockId; 

unsigned nextCubId; 

unsigned numCubs; 

char fileName[] ; //length as recuired 

25 }; 



The dwError field specifies which error, if any, has occurred in initiating the playing of 
the file. The playlncarnation field specifies the play incarnation, and the tigerFileld 
field holds the tigerFileld for the controller 14. The numFileBlocks field specifies how 

30 many blocks are in the file. The fileBlockId field holds the Id for the block at which 
playing is initiated. The nextCubId field holds the Id of the cub 22A, 22B or 22C which 
will start playing the first block of the file. The numCubs field specifies the number of 
cubs 22A, 22B and 22C in the media storage 16. Lastly, the fileName field holds the 
name for the file that is being played. 

35 All of the above-described messages are passed over the control link 18. 

The read data from the media storage 16 is passed over the data funnel 20 (see step 46 
in Figure 5). The media storage 16 begins forwarding blocks of the file of data to the 
viewer 26 over the data funnel 20 (step 46 in Figure 5). The blocks are delivered 
asynchronously from the cubs 22 A, 22B and 22C of the media storage 16 over the data 

40 funnel 20 to the viewer 26. 

The messages are transferred as datagrams, where a datagram is a group 
of one or more packets that logically represent a single message. A packet is a single 
unit that is transmitted by the network hardware. The size of packets may vary. For 
example, in an "ETHERNET" network, packets may range in size from about 20 bytes 
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to about 1500 bytes, whereas in an ATM network, the packets may range from 48 bytes 
to about 64 kilobytes. When a datagram contains more than one packet it is said to be 
"fragmented" and the packets that make up the datagram constitute "fragments.'* 

In a heterogeneous network, it is possible that different pieces of the 
5 network have different maximum packet sizes. The use of datagrams helps to bridge 
between such networks. An application may control the datagram size, which is 
logically independent of the packet size. In one embodiment of the present invention, a 
528 byte datagram size is chosen because it works well with a given file format on the 
Internet. Blocks of data are transmitted across the network in frames. For certain 
10 transport protocols, a frame is a datagram. In other transport protocols, a frame is an 
arbitrary size that correlates with the maxFunnelBytes value. 

The blocks are transmitted in frames, and each frame includes a 
compressed funnel header having the following format. 

15 struct CompressedFunnelFrameHeader { 

unsigned frameOffset; 

unsigned f rameLength; 

int playlncarnation; 

unsigned short playSequence; 
20 unsigned short fileBlocJcId; 

unsigned chunkLength; 

}; 

The frameOffset field specifies the offset at which the data begins relative to the 
25 beginning of the block. The frameLength field specifies the length of the frame. The 
playlncarnation field holds an incarnation for a play request. The playSequence field 
holds a value that identifies where the block fits into the playing sequence. The 
fileBlockld field holds a numerical identifier for the block that is held in the payload of 
the frame and the chunkLength field holds the total amount of data to be sent for the 
30 block. 

An example helps to illustrate how these fields are utilized. Suppose that 
a block of size 200 kilobytes is to be sent over the data funnel. The maximum datagram 
size is 128 kilobytes. The block of data is sent in two datagrams. The first datagram 
has a frame offset of 0, a frame length of 128 kilobytes, and a chunk length of 200 
35 kilobytes. The first datagram contains the first 128 kilobytes of data in the block. The 
second frame has a frame offset of 128 kilobytes, a frame length of 72 kilobytes, and a 
chunk length of 200 kilobytes. The second datagram contains the remaining 72 bytes of 
the block. 

The cubs 22A, 22B and 22C cause the blocks of the file to be delivered 
40 at a particular frequency based upon a datagram size being used for the data funnel 20 
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and the block play time. The blocks are delivered until end of file is reached, assuming 
no errors or other intervening requests (step 46 of Figure 5). 

The system must then clean up by first closing the file and then closing 
the funnel and control link connections, respectively (step 47). The file is closed by 
5 sending the following message from the viewer 26 to the controller 14. 

struct LinkViewerToMacCloseFileMessage 
: public LinkMessage { 

unsigned openFileld; 

10 }; 

The message holds the file Id for the file to be closed. 

The funnel 20 is closed by sending a disconnect message from the 
viewer 26 to the controller 14. The disconnect message has the following format 

15 

struct LinkViewerToMacDis connect FunnelMes sage 
: public LinkMessage { 

}; 

20 The controller 14 receives the disconnect message, disconnects the 

funnel and returns the following message. 

struct LinkMacToViewerReportDisconnectedFunnelMessage 
: public LinkMessage { 
25 Win32Error dwError; 

}; : 

The dwError field specifies whether an error occurred in disconnecting the data funnel 
20. If for some reason, such as a problem in the underlying network, the data funnel 20 

30 closes, the controller 14 generates a disconnected funnel message without a recipient 
request to close the data funnel from the viewer 26. 

The control link 18 is disconnected using mechanisms provided by the 
TCP/IP protocol. Those skilled in the art will appreciate that the control link 18 and 
funnel 20 need not be disconnected immediately after the file is no longer playing; 

35 rather, these connections may remain intact to be used further. 

Typically, a file is played until end of file is reached. However, the 
viewer 26 may terminate the playing of a file by sending the following message. 



struct LinkViewerToMacStopPlayingMessage 
40 : public LinkMessage { 

}; 
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When the controller 14 receives this message, the controller terminates 
the playing of the file so that the blocks of the file are no longer transmitted over the 
funnel 20. 

A file may also stop playing in situations where an error or other event 
5 forces the termination of the playing of the file. 

The preferred embodiment of the present invention is not limited to 
playing the whole file but rather facilitates the playing of blocks of a file on a block-by- 
block basis. In particular, the viewer 26 may request that a particular block or portion 
of a block of a file be played. The viewer 26 makes a request to play a block by sending 
10 the following message to the controller 14 (step 51 in Figure 6). 

struct LinkViewerToMacReadBlockMessage 
: public LinkMessage { 

uns igned openFi le Id ; 

15 unsigned fileBlockld; 

unsigned offset; 

unsigned length; 

unsigned flags; 

Time tEarliest; 
20 Time tDeadline; 

int play Incarnation; 

int playSequence; 

}; 



25 The openFileld field holds the Id for the file from which the block is to be read. The 
fileBlockld field holds the Id of the block that is to be read. The offset field specifies 
the offset within the block of the portion requested to be played. The length field 
specifies the number of bytes to send. If the viewer 26 requests that data beyond the 
end of the block be sent (because offset length is greater than or equal to block size), the 

30 controller 14 reduces the length field so that only valid data will be sent, part of the 
flags field is used for system debugging information and the remainder is reserved for 
future use. The tEarliest field specifies the earliest time at which the block may be 
scheduled to be read, and the tDeadline field specifies the latest time at which the block 
may be read. The playlncamation field specifies the incarnation for the request, and the 

35 playSequence field specifies where the read block request fits into a sequence of block 
read requests. 

In response to the viewer 26 request, the controller 14 sends an 
acknowledgment message to the viewer 26 and reads the requested block of 
information. The acknowledgment message takes the following form. 



40 



14 



s t ruct LinkMacToViewe rRepo rtReadBlockMess age 
: public LinkMessage { 
Win32Error dwError; 
int playlncarnation; 
int playSequence ; 

}; 



The dwError field specifies an error code which indicates which error, if any, occurred 
during the reading of the block of the file. The playlncarnation field holds the play 
10 incarnation value, and the playSequence field holds the value that identifies where the 
block fits within a play sequence. 

The viewer 26 may also explicitly request the cancellation of one or 
more read block requests by sending the following message. 

15 struct LinkViewerToMacCanceiReadBlockMessage 

: public LinkMessage { 
int playlncarnation; 

}; 

20 The cancellation request message specifies the play incarnation associated with the 
request. 

The preferred embodiment of the present invention also enables a viewer 
26 to write data to the media storage 16. Figure 6 is a flowchart illustrating the steps 
that are performed in such a writing operation. Initially, the viewer 26 sends a request 
25 to the controller 14 to write a block of data (step 51 in Figure 6). It is assumed that the 
viewer 26 has already allocated a file on the storage media 16. In order to allocate a 
file, the viewer 26 sends the following message. 

struct LinkViewerToMacAllocateFileMessage 
30 : public LinkMessage { 

int playlncarnation; 
char newName; 
MmsFileEntry newMmsFileEntry [1] ; 

>; 

35 

The playlncarnation field specifies a play incarnation for allocating the file. The 
newName field identifies the file name for the new file and the newMmsFileEntry field 
holds file information. 

The controller 14 receives the request to allocate a file, attempts to 
40 allocate the file, and sends the following response message: 
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struct LinkMacToViewerReportAllocatedFileMessage 
: public LinkMessage { 
Win32Error dwError; 
int playlncarnation; 
5 unsigned openFiield; 

uns igned tige rFi le Id ; 

unsigned blockODiskld; 
unsigned blockOCubld; 

}; 

10 

The dwError holds an error code that specifies whether an error occurred and identifies 
any error that did occur. The playlncarnation field specifies a play incarnation value. 
The openFiield field holds a handle for the file that has been allocated The tigerFileld 
holds an id for the file. The blockODiskld field holds the id of the disk that holds the 
15 first block of the file that has been allocated. Lastly, the blockOCubld field holds the 
value of the id for the cub that holds block 0 of the allocated file. 

Once the file is allocated and opened, the viewer 26 may request that a 
block be written to the file by sending the following message. 

20 struct LinkViewerToMacWriteBlockRequestMessage 

: public LinkMessage { 

unsigned openFiield; 
unsigned fileBlockId; 
unsigned numB lockB ytes; 

25 int playlncarnation; 

}; 

The openFiield field specifies the file Id for the file to which the block of data is to be 
written. The fileBlockId field holds an Id for the file block that is to be written. The 
numBlockBytes field specifies the number of bytes in the block, and the 
playlncarnation field holds the incarnation value for the write operation. The controller 
14 sends a message to the cubs 22A, 22B and 22C to prepare for the data to be written. 
The controller 14 returns an acknowledgment to the viewer 26 that contain the tag and 
an identifier for the cub that holds the file to which the block of data is to be written 
(step 52 in Figure 6). The acknowledgment message has the following format. 

struct LinkMacToViewerReportWriteBlockRequestedMessage 
: public LinkMessage { 
Win32Error dwError; 
40 int playlncarnation; 

unsigned operationTag; 
unsigned cubid; 

Time wbStamps [H-WBStampRequestedOnTiger] ; 

}; 

45 

The dwError field holds an error code that either identifies an error or indicates that no 
error occurred during the request for the write block. The playlncarnation field holds a 
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value for the play incarnation. The operationTag identifies the operation being 
performed because multiple operations may be performed at the same time. The cubld 
field identifies the cub to which the block is to be sent, and the final field is a set of time 
stamps. 

5 The viewer 26 then sends a funnel write data header over the funnel 20 

to the appropriate cub (step 54 in Figure 6). The funnel write data header has the 
following format. 

struct FunnelWriteDataHeader { 
10 unsigned operationTag; 

int playlncarnation; 
unsigned numBiockBytes; 

}; 

15 The operationTag field specifies a tag that identifies the operation to differentiate it 
from other operations. The playlncarnation field holds the current play incarnation 
value and the numBiockBytes field holds the number of blocks being sent in the write 
block. The viewer sends the block of data over the funnel to the appropriate cub (step 
56 in Figure 6). When the writing is completed, the controller 14 sends a message to 

20 the viewer 26 indicating that the write of the block is completed (step 58 in Figure 6). 
This acknowledgment message has the following format. 

struct LinkMacToViewerReportWriteBiockCompietedMessage 
: public LinkMessage { 
25 Win32Error dwError; 

int playlncarnation; 

Time wbStamps [ 1+WBStampWrittenOnTiger ] ; 

}; 

30 The acknowledgment specifies an error code, a play incarnation and a set of time 
stamps. 

The protocol also facilitates the viewer 26 sending a request to obtain 
information from the controller 14. Figure 7 is a flowchart of the basic steps that are 
performed. Initially, the viewer 26 sends an information request message to the 
35 controller 14 over the control link 18 (step 62 in Figure 7). The controller 14 then 
returns information to the viewer in the form of a response message (step 64 in Figure 

In order to understand the utility of the steps shown in Figure 7, it is 
helpful to review some of the messages that may be sent to request information and to 
40 provide requested information. For example, the viewer 26 may request information 
about a particular controller 14 by sending the following message. 
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struct LinkViewerToMacTigerlnfoMessage 
: public LinkMessage [ 
char tigertfameU ; //length as required 

5 }; 

The viewer 26 may also request information about the funnel 20 by- 
sending the following message, 

10 struct LinkViewerToMacFunnellnfoMessage 

: public LinkMessage { 

}; 

The controller 14 receives the request from the viewer 26 and returns the following 
15 message. 

struct LinkMacToViewerReportFunnellnfoMessage 
: public LinkMessage { 

unsigned transportMask; 
20 unsigned nBlockFragments; 

unsigned f ragmentBytes ; 

unsigned nCubs; 

unsigned failedCubs; 

unsigned nDisks; 
25 unsigned decluster; 

unsigned cubddDatagramSize; 



The transportMask field is a bit mask that specifies which transports are 
30 supported. The nBlockFragments field specifies the number of fragments that may be 
in a block (in this context "fragments" refers to portions of the data block on secondary 
storage). The fragmentBytes field specifies the number of bytes in each fragment. The 
nCubs field specifies the number of cubs in the media storage 16 that are connected via 
the data funnel 20, and the failedCubs field is a bit mask that specifies whether any of 
35 . the cubs have failed or not. The nDisks field specifies the number of disks in the media 
storage 16. The decluster field specifies how information is mirrored in the media 
storage 16. Lastly, the cubddDatagramSize field specifies the datagram size that is 
utilized by the cubs 22A, 22B and 22C. 

The viewer 26 may request information about a particular file by sending 
40 the following message. 

struct LinkViewerToMacFilelnfoMessage 
: public LinkMessage { 

int playlncarnation; 
45 char completeFileName[] ; //length as required 

}; 
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The message specifies a playlncamation and a FileName. The controller 14 responds 
by returning the following report message. 



struct LinkMacToViewerReportFilelnfoMessage 
: public LinkMessage { 
Win32Error dwError; 
int playlncamation; 
MmsFileEntry entry [1] ; 

}; 



The report message includes an entry that holds information about the file as well as a 
playlncamation value and an error code. 

In addition to obtaining information about a file, the viewer 26 may also 
obtain directory information from the controller 14 by sending a request for directory 
15 information having the following format 

struct LinkViewerToMacDirectoryEntriesMessage 
: public LinkMessage { 

char *tigerName; 
20 int incarnation; 

uns igned nPatterns ; 

unsigned startingFileld; 

char *patterns [ nPatterns ] ; 

}; 

25 

The message specifies the controller (/.<?., tiger) in which the directory entries are 
maintained. An incarnation value for the request is included in the message, and the 
number of patterns to be searched is specified in the nPatterns field. It should be 
appreciated that this request does a textual search to look for certain textual patterns 
30 among the directory entries. The *patterns[nPatterns] field specifies the patterns that 
are to be sought. The starting file ID specifies where in a list of files the search is to 
begin. 

The controller 14 receives the request for directory information and 
returns a report. The report message has the following format. 

35 

struct LinkMacToViewerReportDirectoryEntriesMessage 
: public LinkMessage { 

int incarnation; 

unsigned nFiles; 
40 unsigned nVaiid; 

unsigned ninitialized; 

unsigned nBlocks; 

unsigned nFree; 

unsigned nEntries; 
45 int complete; 

TigerDirectoryEntry entries [nEntries ] ; 

}; 
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The report message includes the incarnation value to delineate this response from other 
responses and to match up the response with the request. The nFile field specifies the 
number of files in the system. The nValid field specifies the number of files that are 
valid, and the nlnitialized field specifies the number of files that have been initialized 
5 The nBlocks field specifies the number of blocks on the media server system. The 
nFree field specifies the number of free blocks and the nEntries field specifies the 
number of directory entries in this message that match the patterns that were requested. 
The complete field specifies whether the end of the response to the request for directory 
entries is contained in the message. Oftentimes the response is too large for one 

10 message and must be broken into multiple messages. Lastly, the entriesfnEntries] field 
is an array for each matching directory entry that describes the directory entry. 

The viewer 26 may also request a number of administrative functions be 
performed at the controller 14. For example, the viewer 26 may request that a file be 
removed from the storage on one of the cubs 22A, 22B and 22C. The viewer initiates a 

15 request by sending a message with the following format. 

struct LinkViewerToMacRemoveFileMessage 
: public LinkMessage { 

int playlncarnation; 
20 char fileName[] ; //length as required 

}; 

This format specifies a play incarnation and a file name. The controller 14 receives the 
request and attempts to perform the request. The controller 14 then returns a message 
25 with the following format. 

s t ruct LinkMacToVie we rRepo r tRemovedFi leMes sage 
: public LinkMessage { 
Win32Srror dwError; 
30 int playlncarnation; 

}; 

The report message indicates whether the removal of the file was successful and also 
returns to the play incarnation so as to disambiguate this report message from other 
35 report messages. 

A viewer may request that a file be renamed. Specifically, the viewer 
sends a message with the following format. 

struct LinkVi ewe rToMacRenameFileMes sage 
40 : public LinkMessage { 

int playlncarnation; 
char *newName; 

char oldName [} ; //length as required 

}; 
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This message includes the old name of the file, the new name of the file to which the 
file is to be renamed and a play incarnation value. The controller 14, in response, 
attempts to rename to the file and sends a report message having the following format. 

5 

struct LinkMacToViewerReportRenamedFileMessage 
: public LinkMessage { 
Win32Error dwError; 
int playlncarnation; 

10 }; 

The report message specifies whether an error occurred and returns a play incarnation 
value. 

A viewer 26 may also request that a file be initialized so that the file is at 
15 a state that is ready to be played. The viewer 26 sends such a request by sending a 
message with the following format. 

struct LinkViewerToMacInitializeFileMessage 
: public LinkMessage { 
20 int playlncarnation; 

unsigned openFileld; 

}; 

The request message includes a play incarnation value and a file ID for 
25 the file that is to be initialized. The controller 14 responds by attempting to initialize 
the file and returning a request message that specifies whether the initialization was 
successful or not. The response message has the following format. 

struct LinkMacToViewerKeporttnitializedFileMessage 
30 : public LinkMessage { 

Win32Error dwError; 

int playlncarnation; 

}; 

35 As shown in Figure 8 the viewer may also send messages over their 

control link 18 that prompt no report message in return (step 66 in Figure 8). One 
example of such a message is a message the viewer 26 sends to the controller 14 to 
indicate that the viewer did not receive a block that was transmitted over the data funnel 
20. This message is especially useful because many protocols, such as UDP, cannot 

40 guarantee arrival of a data block. The message the viewer 26 sends has the following 
format. 
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struct LinkViewerToMacReportLostBlockMessage 
: public LinkMessage { 
int scheduled; 
Buf f er DataHeader header [ 1 ] ; 

}; 



The scheduled field specifies whether the block was scheduled as a block read or 
scheduled as part of a file read. The header field identifies the block. 

The viewer may also send a message indicating that the block that was 
10 transmitted was damaged. The viewer 26 indicates such a damaged block by sending 
the following message to the controller 14. 

struct LinkViewerToMacReportDamagedBlockMessage 
: public LinkMessage { 
15 BufferDataHeader header [1]; 

}; 

This message includes the data header for the block that was damaged. 

While the present invention has been described with reference to a 
20 preferred embodiment thereof, those skilled in the art will appreciate that various 
changes in form and detail may be made without departing from the intended scope of 
the present invention as defined in the appended claims. 



